IMPORTANT

Future versions of MRJ, which implement Sun's JDK 1.1 standards, will let you assign keyboard equivalents by binding MenuAccelerator objects to a menu item, so you do not need to use SetMenuItemCmdKey .

The SetMenuItemCmdKey method allows you to assign a keyboard equivalent of the form "Command- character " to a menu item. The SetMenuItemCmdKey method is overloaded; you can specify the menu item by referencing the menu item by name or by menu name and menu index. Listing 1-7 shows code that creates items in a menu and assigns them keyboard equivalents.

Listing 1-7 Assigning a keyboard equivalent to a menu item.

import com.apple.mrj.*;
import java.io.*;
import java.awt.*;

...

class MenuTest extends Frame {
    MenuTest() {
        MenuBar mb = new MenuBar();
        Menu menu = new Menu("Menu");

        menu.add("Hop");
        menu.add("Skip");
        menu.add("Jump");
        mb.add(menu);
        setMenuBar(mb);
        
        MRJMenuUtils.setMenuItemCmdKey(menu, 0, '1');
        MRJMenuUtils.setMenuItemCmdKey(menu, 1, '2');
        MRJMenuUtils.setMenuItemCmdKey(menu, 2, '3');

        show();
    }
    
    public boolean handleEvent(Event eve) {
        if (eve.id == Event.ACTION_EVENT)
            System.out.println(eve);
        return false;
    }
}

This code creates a menu named Menu which has three menu items associated with it: Hop , Skip , and Jump . It then assigns each a keyboard equivalent. For example, entering Command-1 would select the menu item Hop . The keyboard equivalent appears in the menu item next to the item name.

The rest of the code is a simple event handler that traps an event (that is, the selection of a menu item) and prints the contents of the Apple Event record to the standard output.

Although you can choose any letter or number to go with the Command key, most Mac OS applications have certain keyboard equivalent conventions, which you should follow. Table 1-2 shows some of the more common conventions.

Table 1-2 Some Mac OS keyboard equivalent conventions

Keyboard Equivalent	Menu Action
Command-N	Create a new document
Command-O	Open a file
Command-W	Close a window
Command-Q	Quit the application
Command-P	Print the current document
Command-S	Save the current document
Command-A	Select all
Command-C	Copy selection
Command-X	Cut selection
Command-V	Paste into selection
Command-Z	Undo last action

For more information about keyboard equivalents, see the "Menu Manager" chapter of Inside Macintosh: Macintosh Toolbox Essentials .

---

© 1998 Apple Computer, Inc. — (Last Updated 10 Dec 98)

Previous | Back Up One Level | Next |